home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 34.zip / BS1 part 34 / FredFish PD 319.adf / CNewsSrc / uupc.lzh / uupc / README.Amiga < prev    next >
Text File  |  1990-01-16  |  5KB  |  106 lines
  1. This file contains Jeff Lydiatt's README as well as my own.  In the
  2. future, others may be tacked onto the end.
  3.  
  4. Frank Edwards
  5. -------------------------------------------------------------------------
  6. README.Amiga             July 29, 1987        Jeff Lydiatt
  7.  
  8. This directory contains all the support code for the dcp serial
  9. I/O  routines,  the  directory  manipulation  support,  code to
  10. support  a  portable version of the unix getenv() function, and
  11. the startup code  for  both  uupc  and  mail.   Here is a brief
  12. description of the files:
  13.  
  14. Directory of PCMail:PCMail/AMIGA
  15.  
  16.   makefile    - compiles support modules for this directory.
  17.   Makefile.ami - makefile for uupc directory
  18.   genv.h    - header file for genv.c
  19.   host.h    - includes for uupc and mail programs.
  20.   ndir.h    - Amiga version of unix directory structures.
  21.   SerialIO.c    - very low level serial I/O device support.
  22.   Timer.c    - provides low level timer device support.
  23.   chdir.c    - chdir( path), makes "path" the current directory. 
  24.   genv.c    - reads the profile, provides getenv() function.
  25.   genv.dyna    - more flexible version of the above, but gurus!
  26.   getcwd.c    - return the path name of the current directory.
  27.   host.c    - prologue and epilogue for both uupc and mail. 
  28.   mkdir.c    - code for mkdir() to make a directory.  
  29.   mlib.c    - not sure: not used by anything I can see.
  30.   ndir.c    - defines opendir(), readdir(), and closedir(). 
  31.   sio.c        - defines SIOInit(), SIOSpeed(), SIOInBuffer(),
  32.           SIOClose(), SIOWrite(), SIORead()
  33.   sleep.c    - implements sleep( seconds ); 
  34.   ulib.c    - implements dcp routines swrite(), sread(), openline(),
  35.           closeline(), rnews(), and shell().
  36.  
  37.  
  38. You  should first compile all the all the files in this directory
  39. using  the  makefile supplied.  Not all files need to be compiled
  40. here.   Some  of  the  object  modules need to be in the primary,
  41. portable-file  directory  and  will  be  included  as needed from
  42. there.
  43.  
  44. BUGS:
  45.  
  46. This  version  has  been  compiled  and tested under Manx Aztec C
  47. v3.40a  with patch 3 installed.  I have been using it extensively
  48. over  the  past couple of weeks with minor problems.  There is an
  49. occasional guru that I can't seem to trace down, so beware.
  50.  
  51. There  seems to be a problem if the functions contained in genv.c
  52. uses  malloc  to  support  environment  variables.   The genv.bac
  53. version  contains  a  slightly  out of date version that would be
  54. much nicer to use if someone can find the problem.
  55.  
  56. If you have any questions, please contact me:
  57.  
  58.    jlydiatt@jlami.van-bc.UUCP   (Jeff Lydiatt)
  59.    {ihnp4!albera!ubc-vision,uunet}!van-bc!jlami!jlydiatt
  60. -------------------------------------------------------------------------
  61. As of Dec 12, 1989, I have been using Manx 3.6a for developing the
  62. UUPC/Mail code with no problems during execution.  (Including Jeff's
  63. occasional guru :-)  There is a bug (I assume) in Lattice's stub for
  64. the serial I/O device, since the modem communication routines don't
  65. work when compiled with Lattice, but *DO* work under Manx!!
  66.  
  67. You will also need the ../libcnews.lib library when linking this package
  68. since the built-in rnews() function makes use of it.  Also the ../include
  69. directory for similar reasons.  Otherwise, examine the makefile and if
  70. you like the flags, type MAKE!!  (CNews can be turned off by removing
  71. the -DCNEWS in the CFLAGS variable in the Makefile.  Since I personally
  72. don't want it turned off, I haven't tried this yet.)
  73.  
  74. I have made *many* modifications to the source since the time I got it.
  75. I'll try to give a run-down:
  76.  
  77.     changed strlen/strcpy to memset/memcpy, as appropriate, in dcpgpkt.c,
  78.     added output to the SYSLOG file (looks like HDB's xferstats),
  79.     moved SYSLOG and LOGFILE into $LOGDIR instead of $SPOOLDIR,
  80.     added C-News support in the form of a built-in "rnews()"
  81.         (see ulib.c and rnews.c),
  82.     cleaned up the code in pcmail.c
  83.         added an interactive subject line prompt,
  84.         additional headers,
  85.         news-posting support,
  86.         changed the format of the header listing when reading mail,
  87.         and more
  88.  
  89. Future additions include:
  90.  
  91.     CALL TIME support for the Systems file (unimplemented right now)
  92.     Permissions file as in HDB
  93.     Some method for externalizing the dialer(s) (HAYES is it, for now)
  94.     Full-screen, Intuition-oriented mail reader
  95.     Full-screen, Intuition-oriented news reader (this one may have
  96.         to wait for awhile since I don't have the news reader from
  97.         the CNews package)
  98.  
  99. I can be reached (usually) at:
  100.  
  101.     crash!ckctpa@boake2 <Frank J. Edwards>
  102.                 which is
  103.     ...!uunet!pdn!boake2!ckctpa!crash
  104.  
  105.     or at (813) 786-3675, if you prefer.
  106.